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Bash Shell Programming Course 


Introduction 


bash - Bourne Shell Again Shell (other Shells: csh, tcsh, zsh, etc...) 


Command allowing a user to change permanently his shell in 
/etc/passswd: 


eg.chsh -s /bin/ash 
Shell must be in the list of valid shells/etc/shells. 


Exercise: 
- Start konsole and try: 
alias (Bash's aliases) 
csh 
alias (Cshell's aliases) 


Shell scripts programming purpose 
- Automatization, Flexibility, Exploit the power of each command 


Requirements and how-to of running a shell script 
- Make the script executable (access rights 755) 
- Interpreters name at start of script (#! /bin/sh or #! /bin/bash) 


- Use the ./ before the script file name to run the script located in the path 
where we are. 


- Reading external scripts using '. /script/path/name' 
eg. Useofthe . /etc/rc.status in SuSE scripts(library of functions) 


To check the exit status of a the last run script: 
echo $? 


Scripts exit status can be controlled by the command exit x (x = exit status) 


To Prevent overwriting files via '>' operator: 
set -o noclobber Or set -C 
Exception: operator '> |' can override this with for a single file. 


Meta-characters in bash: 
$&; () {} []*ž?!<> 
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- Debugging shell scripts: 
Display all the executed lines as it executes them. 
/bin/sh -xv Scritpname [ScriptParameters] 
or install the program bashdb (bash debug) and runtit with the command: 
bashdb -t debug_terminal_device scriptname 
eg. bashdb -t /dev/pts/3 /home/michel/bin/scriptl 
or set the mode (-x) afterwards with the command 
set -x 


- Set variables display and stops in the script 
echo $variable ; read dummy 


e Scripts Headers 
#! /bin/bash 


# Name: Scriptname 

# Purpose: Purpose of script.... 

# Syntax: scriptname [options] parameterl parameter2 

# Output: Output of script if any 

# Author: Author Name 

# History: 12.05.2003 First inplementation of script 
# 24.06.2003 Added option -e for erase 

# 


«e GLOBAL, Local, Special Variables and Special Parameters. 
- GLOBAL(exported from the shells that started it) are often named in capitals. 
eg. EDITOR, DISPLAY etc 


- Local (created and valid only in current script) are often named in small letters. 
eg. programl, contentl, result etc. 


- Special keywords (reserved Environment variables names) 
eg. CDPATH, HOME, IFS, LANG, MAIL, MAILCHECK, MAILPATH, PATH, 
PS1,PS2,SHACCT, SHELL, TERM 


- Special Parameters (reserved short variable names having a specific meaning) 
eg. $n, S#, S$@, oy $?, SS, Sl, Sis 


- Suggestions concerning Variables of programs: 
- Set most of the used programs (incl. paths) in variables 
eg. iptables="/usr/sbin/iptables” 
ifconfig="/sbin/ifconfig” 


- Test the presence of programs used in script before using them 
eg. test -x $iptables || exit 5 


- Loading of external functions. 
eg. (using SuSE) . /etc/rc.status 


dirname Extracts the path from a filename that includes the path. 
eg. dirname /usr/local/httpd/htdocs/index.html 
result: /usr/local/httpd/htdocs 


basename Extracts the name from a filename that includes the path. 
eg. basename /usr/local/httpd/htdocs/index.html 
result: index.html 
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Practical Bash programming exercises: 


- First minimal script : Bash special parameters '$x: bashtest' 
(Learning: $n, $#, $@, $*, $?, $$, $!, $is, special variables) 


Michel Bisson 


#!/bin/sh 

# Name: bashtest 

# Author: Michel Bisson 

# Syntax: bashtest paraml param2 param3 

# Date: 31 January 2005 

# Purpose: Test script for bash programming course 
# 

# SPECIAL COMBINATIONS WITH 'S' 


echo "Values of positional parameters'\$1 \$2 \$3': $1 $2 $3" 
echo "The number of positional parameters'(\S#)' is : S#" 


# $S@=Same as echo $1 $2 $3 


echo "All positional parameters'(\$@)' are : $@" 
# $*=Same as echo "$1 $2 $3". Understood as one parameter 
echo 'All positional parameters (\$*):' $* 


ls / &>/dev/null 
echo "Exit status'(\$?)' of last command(ls /): $?" 


ls /ggg &>/dev/null 
echo "Exit status'(\$?)' of last command(ls /ggg): $?" 


echo "PID of current shell'(\$\$)': $s" 

xterm & 

echo "PID of last background command'(\$\!)': $!" 

ps 

kill $1! 

ps 

# BASH SPECIAL VARIABLES 

echo "Variable MAILPATH is: $SMAILPATH" (Not exported) 
echo "Variable MAIL is: SMAIL" (Not exported) 
echo "Variable MAILCHECK is: $MAILCHECK" (Not exported) 


echo "Variable HOME is: $HOME" 
echo "Variable LANG is: SLANG" 
echo "Variable SHELL is: SSHELL" 
echo "Variable TERM is: STERM" 
echo "Variable PATH is: $PATH" 
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Michel Bisson 


e Create a userinfo script: Shows oll sorts of information on users 
(Learning: for, test, Variable increment with for, ${var} ) 


#! /bin/bash 

# Name: userinfo 

# Purpose: Shows info about users from passwd, shadow 
# and smbpasswd 

# Syntax: userinfo userl user2 user3 ..... 

# History: 12.09.2003 First inplementation of script 
# 

# Taken from /etc/passwd, /etc/shadow and 'id' command 

# for $Benutzer in $@; do 

# echo "Benutzer ist jetz : $Benutzer" 

# done 


Example 1: for using positional parameters 
#for user in $@; do 
for user ; do 


echo "------ Info for User: $user 
grep ““Suser” /etc/passwd 

grep ““Suser” /etc/shadow 

id Suser 


echo " 
done 


Example 2: for using parameter list 

for file in $(1s /boot); do 
echo "Extended Status for:" 
stat /boot/$file 


echo " 
done 


Exapmle 3: for using incremented variable 
#!/bin/sh 


let lines=$ (wc -l /etc/passwd) &>/dev/null 


echo $lines 

start=5 

for ((i=$start; $i<=$lines; i++)); do 
sed -n ${i}p /etc/passwd 

done 
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Example 4: (German) 

#!/bin/bash 

# Name: userinfo 

# Zweck: Information über Bernuter 

# Syntax: userinfo Benutzerl Benutzer2 Benutzer3 
# Datum: 01.02.05 


# Lernziel: 'for' Schleife, $#, $@, test, &&, grep, id, if, '!' 
#--— BER ge E En EEE as En St En 
#if [ S# -ge 1 ]; then 

LE N regel] 

then 


echo "FEHLER: Mindesten eine Parameter soll gegeben." 
echo "Syntax: userinfo Benutzerl Benutzer2 Benutzer3 ..." 


fi 
#------------- Benutzer info Ausdruck ------------- 
for user in $@ 
do 
echo "---- Info für Benutzer '$user' -------------------- " 
echo "/etc/passwd Zeile" 
grep "*Suser:" /etc/passwd 
echo "Info von befehl 'id'" 
id Suser 
# if (su -c "grep "*Suser" /etc/samba/smbpasswd &>/dev/null") 
# then 
# echo "Benutzer $user ist ein SAMBA Teilnehmer" 
# else 
# echo "Benutzer Suser ist kein SAMBA Teilnehmer" 
# fi 
done 
#------------------ 'for' mit eine Liste von dateien -------- 
for file in $(ls /boot); do 
echo: !======== Erweitert info von /boot Dateien ----- 7 
stat /boot/$file 
echo en a cc ey PS ga Ra a L E EIEE a Pn eS ae, ER " 
done 
EA u a SSSSS==> Inkrementale Integer mit 'for' Schleife 


#lines=$ (wc -1 /etc/passwd) &>/dev/null 
let lines=$ (wc -1 /etc/passwd) &>/dev/null 
start=5 
#725 5= Zeile 5 bis letzte Zeile anzeigen 
for ((i=$start; $i<=Slines; it++)); do 

sed -n ${i}p /etc/passwd 


done 
#------------ Letzte Zeile bis Zeile 5 anzeigen 
for ((i=$lines; $i>=$start; i--)); do 
sed -n ${i}p /etc/passwd 
done 
for ((i=$start; $i<=Slines; i=i+2)); do 
sed -n ${i}p /etc/passwd 
done 
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« Bash Shell Functions Declarations: 

Functions are more useful than alias when complex commands are needed especially 
when arguments are given to the function. 

To declare a function use the following format: 


fname () { commandl;command2;...; } 
or 
fname () 
{ 
commandl; 
command2; 


return 0 (0-255) 
} 


to call the function, use the following format: 
fname paraml param2 
The paraml param2 will be recognized as $1 $2 etc inside the function 


Important: 

- Make there is at least one space or a line break between the { or } and the command. 

- fname is the name of the function. 

« The functions should be saved in ~/.bashrc Or ~/.profile if wanted permanently. 

- Positional parameters passed to the functions are available through the same method 
($1 $2 $3 etc.) as the script's positional parameters. They do not interfere with each 
other. 

- All variables are global to the script including the functions except the positional 
parameters($# $1 $2 $3) which are local to each individual function. 
Exception: The $0 stays global. 

« The exit status of a function is the exit status of the last command executed in the body 

of the function. 

The command return exits the function and resumes after the function call. 

« The function can be exported using the command: export -f Functioname 


- Function exercise Graphic Display of a message(using xmessage) as 
needed. 

#!/bin/bash 

# Name: flashtime 

# Purpose: Flash for 4 sec a message and then kills it 

# waits 6 sec. then flash the time again...... 

# Syntax: flashtime 

# 

# Declare the function 

flash () { 


xmessage -center -fn 10x20 "$1" & 


} 


# Create an infinite loop 


while [ "1" ] ; do 
flash "Es ist: $(date +%H.%M.%S)" 
sleep 6 
kill $! 
sleep 10 
done 
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System admin Script: newclient 


(Learning: Script header, standard system commands) 


FULL EXERCISE SCRIPT(english) 
#! /bin/bash 


# Name: newclient 

# Purpose: Adds a new ftp and possibly a samba client 
# (no login, empty home directory, group ftp) 
# Syntax: newclient /homebase username 

# Author: Author Name 

# History: 12.09.2003 First inplementation of script 
# Exit codes: 1 = Number of parameters is not 2 

# 2 = Username already existing 

# 3 = Homebase is not an absolute path 

# 4 = Home directory already existing 

# 

# Defining the system dependant variables--- 


smbpasswd="/etc/samba/smbpasswd" 


# Creating the ftp group 
groupadd ftp 2>/dev/null 


- Checking number of parameters: 
(Learning: if [...-ne...]) 
See Bash Reference Test Integer Operators page 8 
# Checking for the number of parameters 
if [ “S#" -ne 2 ] 
then 
echo “False number of parameters:” 
echo “Syntax: newclient /homebase username” 
exit 1 


fi 

# Declaring variables for better use of positional parameters 
homebase=$1 

clientname=$2 


- Checking of existing user 
(Learning: if (command) and silent checking... &>/dev/null) 
# Checking for existing user 
if (grep ““Sclientname:” /etc/passwd &>/dev/null) 
then 
echo “ERROR: User 'Sclientname' already exist.” 
exit 2 
fi 


- Checking for homebase directory is an absolute path 
# Checking for homebase if it is an absolute path 


if ! (echo Shomebase | grep "*/" &>/dev/null) 

then 
echo “ERROR: Homebase parameter must be an absolute path.” 
exit 3 

fi 
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- Checking of existing home directory 
# Checking for existing home directory. 


if [ -d Shomebase/Sclientname ] 
then 
echo “ERROR: Homebase Shomebase/Sclientname already exist.” 
exit 4 
fi 
#if test -d $1/$2 ; then 
# echo "FEHLER: Heimatverzeichnis $1/$2 schon angelegt" 
# exit 3 
#fi 
#if test -d $1/$2 ; then echo "ERROR: Home directory $1/$2\ 
# already exist." ; exit 3 ; fi 
Bonn START to create the user ---------------- 


# Creating the empty user home directory 
mkdir -p $1/S2 


# Creating the new ftp user 
useradd -s /bin/false -d $1/$2 -g ftp $2 


# Giving the home directory to the new user 
chown $2. 51/52 


# Asking 2 times for the password 
echo “Enter Password 2 times for $2” 
passwd $2 


- Asking if the client should be also a Samba client , add to samba if so. 


(Learning! .... -a ....], test, while, read, $?, case, ${var:="n"} [ "$s1" 
l= "ok" ]) 
#------------- SAMBA ---------- - - - - - - --------------- 
#-- Check if smbpasswd samba config file is present and not a runnable file. 
if [ -e Ssmbpasswd -a ! -x Ssmbpasswd ] ; then 
sl="" 
while [ "$s1" != "ok" J] ; do 


# Asking if client is also a Samba client 
echo -n "Should $2 also be a Samba client? (y/n) [n]": 
read samba 
case ${samba:="n"} in 
# ------- The answer is YES('y' or 'Y') ------ 


echo "Enter Samba password 2 times for $2" 
smbpasswd -a $2 
if [ $? -eq 0 ] ; then 


sl="ok" 
echo "Samba password successfully\ 
entered" 
else 
echo "ERROR: Samba password failed!" 
fi 
FF 
# ------- The answer is NO('n' or 'N') ------ 
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fi 


n|N) 


echo "ERROR: Please answer with 'y' or 'n':" 


esac 
done 


Creating a report 

(Learning: for, echo -n, id, grep, egrep, cut, print empty line (echo) ) 
# Listing all users, their home directories and their INFO 

# and if he is a samba client insert ' (SAMBA) ' 


# ---- Get the list of users having UID= 500-999 ---- 

list=$ (egrep ": [5-9] [0-9]{2}:" /etc/passwd | cut -d: -f1) 

echo "--------- List of normal users from /etc/passwd-------- 1 
echo $list 

echo " " 


# For each user in list get some passwd info, (samba)*, user ID 
for user in Slist ; do 


done 
echo 


echo -n "INFO for $user: $(grep *Suser: /etc/passwd \ 
| cut -d: -£6) :" 
if grep "*Suser:" /etc/samba/smbpasswd &>/dev/null 
then 
echo -n "(SAMBA) : " 
fi 
id Suser 


; echo "Client account for $2 is added successfully" 
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FULL EXERCISE SCRIPT(Deutsch)New Version 
#!/bin/bash 


Name: newclient 

Zweck: Neue FTP/Samba Client anlegen 
Syntax: newclient homepfad benutzer 
Exit Codes: 1 = Falsche Parameter Anzahl 


2 = Benutzer schon existiert 
3 = homepfad ist nicht Absolute 
4 = homeverzeichnis schon existiert 


tHe H H OHH H H H H 


== --- Farbe definieren ---------------- 
ROT="\\033[31m" 

GRUEN="\\033[32m" 

GELB="\\033[33m" 

FETT="\\033[1m" 

BLAU="\\033[34m" 

NORMAL="\\033 [m" 


#----------- Pfad von Samba Kennwort Datei 
smbpasswd="/etc/samba/smbpasswd" 

#----------- FTP Gruppe anlegen 

groupadd ftp &>/dev/null 

#----------- Parameter ersetzen 

homepfad=$1 ; benutzer=$2 

#----------- Anzahl von Parameter testen. Soll 2 sein. 


if [ S# -ne 2 ] ; then 
echo -e "${ROT}FEHLER: Falsche Anzahl von Parameter." 
echo -e "Syntax: newclient homepfad benutzer. S$NORMAL" 


#---------- Benutzer Ueberpruefen ----------------- 
#if (grep "*Sbenutzer:" /etc/passwd &>/dev/null); then 
if (id Sbenutzer &>/dev/null); then 
echo -e "S{ROT}FEHLER: Benutzer 'Sbenutzer' existiert 
schon. SNORMAL" 


exit 2 
fi 
# --------- homepfad als absolute Pfad Ueberpruefen -------------- 
if ! (echo Shomepfad | grep "*/" &>/dev/null) 
then 


echo -e "S{ROT}FEHLER: homepfad Parameter ist nicht ein absolute 
Pfad. $NORMAL" 
exit 3 


# --------- Heimatverzeichnis ueberpruefen -------------------- 
if test -e Shomepfad/Sbenutzer ; then 

echo -e "S{ROT}FEHLER: Heimatverzeichnis 'Shomepfad/Sbenutzer' 
is present in System.\nEs soll NICHT existieren. $NORMAL" 


exit 4 
fi 
#--------—- START von neue Benutzer Anlegung -------------- 
echo "Bitte das root Password eingeben" 
# --------- Als root HeimatVerzeichnis und Benutzer anlegen 


su -c "mkdir -p Shomepfad/Sbenutzer ; useradd -s /bin/false 
-d Shomepfad/Sbenutzer -g ftp $benutzer ; passwd Sbenutzer; 
chown $benutzer: Shomepfad/S$benutzer" 

if [ $? -ne 0 ] ; then 
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echo -e "S{ROT}FEHLER: Falsche root Password. SNORMAL" 


else 
su -c "mkdir -p Shomepfad/Sbenutzer" 
# Schleife für SAMBA Benutzer 
while [ "$s1" != "ok" ] ; do 
echo -ne "S{GRUEN}Soll der Benutzer as Samba Benutzer auch 
angelegt? (j/n) [n]SNORMAL" 
read antwort 
#echo Santwort 
# Antwort bearbeiten 
case S{antwort:="n"} in 
j|) 
echo -e "S{GELB}Geben Sie bitte das 'root' 
passwort ein Mal." 
echo -e "Dann zwei Mal der Samba Passwort von 
Benutzer. SNORMAL" 
# ------- als root Samba benutzer anlegen ---- 
su -c "smbpasswd -a Sbenutzer && echo ja >/tmp/tm 
|| echo no >/tmp/tm" 
#------ Falsche root Passwort? 
if [ $? -ne 0 ] ; then 
echo -e "S{ROT}FEHLER: Falsche root 
Password. SNORMAL" 
else 
#----—- mbpasswd behehl ervolgreich ? 
if (cat /tmp/tm | grep ja &>/dev/null); then 
sl="ok" 
echo -e "S{GRUEN}Samba Benutzer 
'Sbenutzer' ist ervolgreich 
angelegt . SNORMAL" 
else 
echo -e "${ROT}FEHLER: Falsches 
Passwort." 
echo -e "Bitter zwei Mal das selbe 
Passwort von Benutzer 
eingeben. SNORMAL" 
fi 
fi 
|N) 
sl="ok" 
echo -e "${ROT}FEHLER: Bitte mit 'j' oder 'n' 
antwortenSNORMAL" 
esac 
done 
fi 
#-------------- Bericht Ausgabe --------------------- 
list=$(grep ":[1-9] [0-9] [0-9] [0-9]:" /etc/passwd | cut -d: -f1) 
for user in $list ; do 
echo Ww = ee ER BER roe BEER ER. te " 
echo "INFO fuer $user: $(grep $user: /etc/passwd | cut -d: -f6)" 
id $user 
done 
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FULL EXERCISE SCRIPT(Deutsch)Old Version 


#! /bin/bash 

# Name : newclient-de 

# Zweck: Eine FTP und möglich SAMBA client anlegen 

# Syntax: newclient-de /homebase username 

# Variable: $0 $1 $2 

# Author: elop klasse 

# History: Ver. 0.01.01 29.09.2003 Erzeugung von Script 
# Ergebnisse: exit code: 

# 1 = Falsche anzahl vom Parameter 

# 2 = Benutzer schon angelegt 

# 3 = Heimatverzeichnis schon angelegt 
# 4 = Homebase nich absolute Pfad 

# 5 = Samba is nicht installiert 

# ar == => 

#--------- Variable definieren ---------- 


smbpasswd="/etc/samba/smbpasswd" 


# Gruppe für FTP cliente erzeugen 
groupadd ftp 2>/dev/null 


# -------------- Parameter Anzahl ist 2 ? 
if [ "S#" -ne 2 ] 
then 
echo "FEHLER: Falsche Parameter Anzahl" 
echo "Syntax: newclient-de /homebase username" 


# -------------- Variable fuer besser lesebarkeit von script---- 
homebase=$1 
clientname=$2 


# --------- Ist die Benutzer schon angelgt? 
if (grep "*$clientname:" /etc/passwd &>/dev/null) 
then 
echo "FEHLER: Der Benutzer is schon angelgt." 
exit 2 
fi 
#--------------- Homebase parameter ist Absolute Pfad? 
if ! (echo $homebase | grep "*/" &>/dev/null) 
then 
echo "FEHLER: homebase Parameter ist nicht eine Absolute Pfad" 
exit 3 
fi 
# -------- Ist der Heimatverzeichnis schon angelegt? 


if test -d $homebase/$clientname ; then 
echo "FEHLER: Heimatverzeichnis $homebase/$clientname schon angelegt" 


exit 4 
fi 
#if [ -d Shomebase/Sclientname ] ; then 
# echo "FEHLER: Heimatverzeichnis $homebase/$clientname schon angelegt" 
# exit 4 
#fi 
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# --------- Benuzer anlegen----------------- 

mkdir -p Shomebase/Sclientname 

useradd -s /bin/false -g ftp -d Shomebase/S$clientname $clientname 
chown $clientname. Shomebase/Sclientname 

echo "Bitte Passwort zwei Mal ftir $clientname eingeben:" 

passwd $clientname 


#--------- Client soll fuer Samba angelegt werden? 
if [ -e Ssmbpasswd -a ! -x $smbpasswd ] ; then 
sl="" 
while [ "$s1" != "ok" ] ; do 


echo -n "Wollen Sie diesen Benutzer fuer Samba anlegen? (j/n) [n]:" 
read samba 
case S{samba:="n"} in 
#------- JA Ich will ---------- 
3. echo "Samba passwort fuer $clientname 2 Mal eintragen:" 
smbpasswd -a $clientname 


if [ "$?" -eq 0 ] ; then 
sl="ok" 
echo "Benutzer $clientname fuer Samba erfolgreich angelegt" 
else 
echo "FEHLER: Sie mussen 2 Mal das Passwort eingeben" 
fi 
#--------- NEIN Ich will nicht --------- 
n|N) 
sl="ok" 
#---------- Bloedsinn eingetragen------- 


echo "FEHLER: Bitter mit 'j' oder 'n' antworten." 


#----- Bericht von script ausgeben -------- 
echo "Inhalt von /etc/passwd" 
# Liste von normale Benutzer in Variable 'list' einfuehlen 


list=$ (egrep ":[5-9] [0-9] {2}:" /etc/passwd|cut -d: -f1) 
#------ -- -- -- -- Schleife: schreibt eine Zeile von 
#-------------- Benutzer Info pro Gueltige Benutzer 


for user in $list ; do 
# Benutzername und Heimatverzeichnis ausgeben 
echo -n "INFO fuer $user: $(grep “Suser: /etc/passwa|\ 
cut =d; -f6) > " 
if grep "*Suser:" $smbpasswd &>/dev/null ; then 
echo -n "(SAMBA) :" 
fi 
# Benutzer Zeile mit Benutzer info von 'id' Befehl erganzen. 
id Suser 
done 


echo 
echo "Klientkonto fuer Benutzer $Sclientname erfolgreich ausgefuehrt" 
exit 0 
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Methods of Testing (exercise in interactive bash) 


Brackets [ .... ] 


[ -r /etc/motd ] && echo "All ok" || echo "NOT ok" 
[ -r /etc/mot ] && echo "All ok" || echo "NOT ok" 


Test command: test option parameter 


test -r /etc/motd && echo "All ok" 
test -r /etc/mot && echo "All ok" 


echo "NOT ok" 
echo "NOT ok" 


test "aa" = "tt" && echo "All ok" echo "NOT ok" 
test "aa" = "aa" && echo "All ok" echo "NOT ok" 
Commands 


ifconfig ethO &>/dev/null && echo "All ok" || echo "NOT ok" 


ifconfig pppO &>/dev/null && echo "All ok" 


| echo "NOT ok" 


Adding testings: AND, OR 


test "t" = "t" -a "r" = "r" && echo "All ok" | | echo "NOT ok" 
[ "a" = "a" -a "b" = "c" ] && echo "All ok" | | echo "NOT ok" 
[ "a" = "a" -o "b" = "c" ] && echo "All ok" | | echo "NOT ok" 


AND for commands exit codes in if condition 


if 


(cat /etc/motd &>/dev/null && cat /etc/fstab &>/dev/null); 


OR for commands exit codes in if condition 
if (cat /etc/motd &>/dev/null || cat /etc/fstab &>/dev/null) ; 


Exercise 1: Creating a client delete script 


To do: 
Script Header 
Client system (ftp) account 


Check if client account exist 
Delete it if so. 


Client Samba account 


Check if client is a Samba client 
Delete it if so. 


Client home directory 


Check if client home directory has files in it. 

Tells that its content will be shown (press Enter to show content) 
Use ls -la homedir | less to show content of home directory 
Ask if it can be erased and erase if yes 


Exercise 2: Service Ports monitor (See file 68 Services_Monitor_Exercise.sxw) 
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- Incrementing loops: sping script: Pings all IPs of a 'C' class subnet 
(Learning: 
Functions, $IFS, [ ..-a..] [..-o..], echo, &>/dev/null,if [ ! ..] ,until) 


check combinations [ check -a check], [| check -o check], 
egrep of variable (echo variable | egrep) 

number increment (let "variable+=1") 

no output on commands results check ( command &>/dev/null) 
negative check (if ! (command) ; then) 


#! /bin/sh 

# - ===> -- Super Ping : sping -----7----- a 
# File: sping 

# Purpose: ping a full subnet (netmask 255.255.255.0) 

# Date: 07.09.2003 

# Author: Michel Bisson 

# Syntax: sping 192.168.70. (the last number is omitted!) 


#— = ee a BEGEE: ————— = solo dern on Don Hasen nn 


# Declare error function using the Variable $errortext: 
# Displays error message and exits with error code 1 
error () { 

echo "Serrortext" 

echo "Syntax: eg. $0 192.168.70. " 


exit 1 
} 
# = = = 
# -------- Check the validity of the given parameter (Partial IP) 
# Only one parameter 
if [ "S#" -ne 1 ] ; then 
errortext="ERROR: Incorrect number of parameters." 
error 
fi 
# Sr ii = 
p SSSR ae Parameter is a correct Partial IP? Correct it if possible 
# Accept if xxx.yyy.ZZZ. OY XXxX.yyy.ZZz 
# if ! (echo $1 | egrep "*[0-9]*\.[0-9]*\.[0-9]*\.?$" &>/dev/null) ; 
if !(echo $1 | egrep "*([0-9]{1,3}\.) {2} [0-9]\.?S" &>/dev/null) ; 
then 
errortext="ERROR: Bad subnet Partial IP Syntax" 
error 
FL 
# a a a E E rc a a em nn Sees SS EO ee 
# Verify validity if all numbers in IP (0-255) 
IFS="." 
len=0 


for num in $1 ; do 
#let "len+=1" 
let len++ 
# Do not accept 192.168.71.XXX (fourth number) 


if [ "Slen" -eq 4 -a "$num" != "" ] ; then 
errortext="ERROR: NO Full IP...Just give a partial IP." 
error 

# Do not accept numbers higher than 255 

elif [ "$num" -gt 255 ] ; then 


errortext="ERROR: Wrong values in partial IP Syntax." 
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error 
# Do not accept empty fields eg. 192..168.30 
elif [ "Snum" = "" -a "Slen" -le 3 ] ; then 
errortext="ERROR: Wrong format of partial network IP." 
error 
fi 
done 
unset IFS 


# Check if subnet IP is valid for local machine in network 


if ! (ifconfig | grep "inet " | grep $1 &>/dev/null) ; then 
errortext="ERROR: Partial Subnet IP is not in our local subnet" 
error 

fi 

# EREN EEE PN E RE E E E Fe ne eee Te De ee eae eee ee SS ae SS E Se eae ee Ba tS a Fe Bee 

# Correct by adding a '.' if missing at the end 

if (echo $1 | egrep "\.S" &>/dev/null) ; then 
netip="S$1" 

else 
netip="S1." 

fi 


#echo Snetip 


# Generate all the IPs from xx.xx.xx.1 to xx.xx.xx.254-- 
netnum=1 


#---- ping them all almost at the same time (sent as separate jobs) 
until [ $netnum -eq 255 ]; do 

/bin/ping -w3 -c1 SnetipSnetnum 1>>/tmp/sping & 

let "netnum++" 


done 

p 2222222222222 222222 
HS Sass SaaS wait a bit to let some answers back ---------- 

sleep 4 

#2 Kill all the ping that are still waiting --- 


killall ping &> /dev/null 


#----------- Show only the pings that received an answer -- 
iplist=$ (grep '64 bytes from' /tmp/sping | cut -d: -f£f1 iy 
cut -d" " -f4 | sort -t. -k4n) 
for ip in Siplist ; do 
name=$ (host Sip | grep pointer | head -n1 | cut -d" " -f 5) 
echo -n "Active Host: $ip" 
if [ Sname ] ; then 
echo " ---> Sname" 
else 
echo 
fi 
done 
#-—- = 
exit 0 
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m Exercise 2 for the class: 


Create a script that displays a message for 4 sec and disappears when a new mail 
comes or a mail is read from the mailbox: 


#!/bin/bash 


# Name: newmail 

# Purpose: Flash a message of newmail for 4 sec and go if 
# new mail arrives or if mail has been read 

# Syntax: newmail 

# 

# Declare the display function 

flash () { 


xmessage -center -fn 9x15 "$1" & 


} 


# 
# Create an endless loop 
while [ "1" ] ; do 
# Any mail at all is present? 
if (mail -H &>/dev/null) ; then 
mailnow=$ (mail -H | we -1) 
# New mail has arrived? 
if [ "Smailnow" -gt "Slastmail" ] ; then 
# How many new mails? 
newmails=S [Smailnow-Slastmail] 
# Show the message 
flash "You have $newmails New Mail" 
sleep 4 
Kill $1 
# Some Mail is been read? 
elif [ "Smailnow" -lt "Slastmail" ] ; then 
# How many mail Read? 
mailread=$ [Slastmail-Snewmail ] 
flash "You have $mailread less mails" 
sleep 4 
kill S! 
fi 
# Actualize the watcher counter 
lastmail=$mailnow 
fi 
sleep 1 
done 
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@ Text pop-up menus with ‘dialog’ 
Creating a simple script to set the Hardware and System clock. 
(Learning: read, dialog, &&, date formats, hwclock) 


#! /bin/bash 


# Name: setwatch 

# Purpose: Change the Hardware and System date and time 

# Just like 'setclock 09/18/2003 21:13:00' 

# Syntax: setwatch 

# Author: Michel Bisson 

# History: 12.09.2003 First inplementation of script 
# 

# Ask for today's Day 


today_d=$ (date +%d) 

echo -n "Enter today's Day (01-31) [Stoday_d]:";read day 
# [ "$day" ] && day=Stoday_d 

[ "$day" = "" ] && day=Stoday_d 


# Ask for today's Month 

today_m=$ (date +%m) 

echo -n "Enter today's Month (01-12) [Stoday_m]:";read month 
[ "$month" = "" ] && month=Stoday_m 


# Ask for today's Year 

today_y=$ (date +%Y) 

echo -n "Enter today's Year (2000-2099) [Stoday_y]:";read year 
[ "$year" = "" ] && year=Stoday_y 


#echo "Today's date is: Smonth/S$day/Syear" 
#exit 0 


# Ask for today's time via dialog pop-up window 
time=$ (dialog --stdout --timebox "Hardware/System time setting:\ 
\nDate: $Smonth/$day/$year" 0 0) 


if [ "Stime" ] ; then 
# Set the hardware clock 
#format: hwclock set date="9/22/2002 16:45:05" 


hwclock set date "Smonth/Sday/Syear $time" 
# Sets the System clock to current hardware clock 
hwclock --hctosys 

fi 

# Show the new Hardware and System date and time 

echo "Present Hardware Clock setting is: $(hwclock)" 


echo "Present System Clock setting is: $(date)" 


exit 0 
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- Creating pop-up Data entry field, menus, yes/no question, and message box. 


(Learning: read, dialog, password entry, shift, eval, $* , $?) 
Creating a script (menu 1) that will bring a pop-up menu and send the result to a pop- 
up message. 


#! /bin/bash 

# Name: menul 

# Purpose: Displays a text menu in terminal 

# - asks for a password 

# - asks for a Presentation text 

# - shows presentation text and choice in a pop-up message 
# Syntax: menul MenuTitle choicel choice2 choice3 ..... 

# Output: The text of one of the chosen 

# Author: Michel Bisson 

# History: 12.09.2003 First inplementation of script 


# Ses Si See SSS ee os oe NS SSeS 
#Preparation: 

#echo 'mypasswd' > ~/.scrpasswd 

# chmod 600 ~/.scrpasswd 


#--— zen = Se —— Da Zn Se EEE Se = —— 

# Allow minimum 3 parameters (title and 2 choices) 

if [ "S#" -lt 3 ] ; then 
echo "ERROR: Wrong number of parameters" 
echo "Syntax: $0 MenuTitle choicel choice2 choice3 ..... " 
exit 1 

fi 


# Ask for a password (now : mypasswd) 
echo -n "Please enter password: " 
read passwd 


# Not completely tested dialog password box 

#passw=$ (dialog --stdout --passwordbox \ 

# "Please enter password for using this script" 0 0) 
#echo Spasswd 

#exit 0 


# Check the entered password against the file ~/scrpasswd 


if [ "Spasswd" != $(cat ~/scrpasswd) ] ; then 
echo "ERROR: Wrong password." 
exit 1 

fi 


# Save the menu title before deleting it (shift) from parameter list 
title=$1 
shift 


# Build-up the beginning of the dialog command 
command="dialog --stdout --menu $title 0 0 $#" 


# Build-up the rest of the dialog command parameters 
# Here we generate a tag (item number) in front of each 
# choice item in command parameter list 
counter=1 
for param in $* ; do 
command=Scommand" "Scounter" "Sparam 
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let "counter++" 
done 


# Execute the dialog menu command 
# The result (item Nr.) is stored in variable 'Sresult' 
result=$ ($command) 


# Ask if user want to display the result 
# (result is exit code 0 for YES and 1 for NO) 
dialog --yesno "Do you want to display the result?" 0 0 


# Display the result of the choice if yes selected 
if [ "S$?" -eq 0 ] ; then 
# Ask for a title for the display of the choice 
mytext=$ (dialog --stdout --inputbox \ 
"Enter the display title of the result:" 10 60) 


# If the the OK button was presssed then 
# print the choice in a pop-up message 
# otherwise notify of cancellation in pop-up message 


if [ "$result" != "" ] ; then 

eval "choice=""\S""Sresult" 

dialog --msgbox "SmytextS$choice" 0 0 
else 

dialog --msgbox "Choice was cancelled" 0 0 
fi 
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- kdialog 


KDialog can be used to show nice graphic dialog boxes from shell scripts 
Syntax: kdialog [Qt-options] [KDE-options] [options] [arg] 


Generic options: 


--help Show help about options 
--help-gqt Show Qt specific options 
--help-kde Show KDE specific options 
--help-all Show all options 
--author Show author information 
-v, --version Show version information 
--license Show license information 
-— End of options 
Options: 
--yesno <text> Question message box with yes/no buttons 


Result is in exit code: O=yes 1=no 
eg.if { kdialog --yesno "Do you want to proceed?" ; } ; then 


--yesnocancel <text> Question message box with yes/no/cancel buttons 
Result is in exit code: O=yes 1=no 2=cancel 


--warningyesno <text> Warning message box with yes/no buttons 
Result is in exit code: O=yes 1=no 


--warningcontinuecancel <text> 
Warning message box with continue/cancel buttons. 
Result is in exit code: O=continue 1=cancel 


--warningyesnocancel <text> 
Warning message box with yes/no/cancel buttons 
Result is in exit code: O=yes 1=no 2=cancel 


--sorry <text> 'Sorry' message box 
--error <text> 'Error' message box 
--msgbox <text> Message Box dialog 


--inputbox <text> <init> Input Box dialog 
Output is in STDOUT. Result is in exit code 
0=<Ok> 1=<Cancel>(with STDOUT empty) 


eg. answer=S (kdialog --inputbox "Enter your name" "Jane Mason") 
--password <text> Password dialog. Replaces typed chars. with ™' 
Output is in STDOUT. 0=<Ok> 1=<Cancel> 


--textbox <file> [width] [height] 
Text Box dialog. 
eg. kdialog --textbox /etc/motd 
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--menu <text> [tag item] [tag item] 
Menu dialog. Output is the tag value of the chosen 
menu text in STDOUT. Result is in exit code. 
0=<Ok> 1=<Cancel> 
tag= 1,2,3..a,b;C ... 
Item="text to select" 


eg. ans=$ (kdialog --menu "Choose item" 1 Iteml 2 Item2 3 Item3) 


--checklist <text> [tag item status] [tag item status] 
Check List dialog. Allows to select multiple items. 
Output is the tag values of the chosen items. 
Result is in exit code. 
0=<Ok> 1=<Cancel> 
tag= 1,2,3..a,b,c ... 
Item="text to select" 
Status=on/off 
eg. 
ans=$ (kdialog --checklist "Select desired items" 1 "bold" on \ 
2 “italic” off) 


--radiolist <text> [tag item status] 
Radio List dialog. Selects only one Item form list. 
Output is the tag value of the chosen item. 
Result is in exit code. 
0=<Ok> 1=<Cancel> 
tag= 1,2,3..a,b,c ... 
Item="text to select" 
Status=on/off 


title <text> Dialog title. Display text with Ok Button 


--separate-output Return list items on separate lines 
(for checklist option) 
--passivepopup <text> <timeout> Passive Popup 
getopenfilename [startDir] [filter] File dialog to open an existing file 
getsavefilename [startDir] [filter] File dialog to save a file 
--getexistingdirectory [startDir] File dialog to select an existing directory 
--getopenurl [startDir] [filter] File dialog to open an existing URL 
--getsaveurl [startDir] [filter] File dialog to save a URL 
--geticon [group] [context] Icon chooser dialog 
--progressbar <text> [totalsteps] Progress bar dialog, returns a DCOP 
reference for communication 
--print-winid Outputs the winid of each dialog 
--embed <winid> Makes the dialog transient for an X app 
specified by winid 
--dontagain <file:entry> Config file and option name for saving the 
"dont-show/ask-again" state 


Arguments: 
arg Arguments - depending on main option 


68_Shell_Programming_Course.sxw - 24 


Linux-Kurs Themen — BASH Shell Programming Course - 26 February 2005 Michel Bisson 


Exercise!: 
#!/bin/bash 
# Name: menu 


# Zweck: menu demo mit kdialog 
# Syntax: menu 
# 
# Kdialog abfragen 
antwort=S (kdialog --menu "Bitte Operation whaehlen" \ 
1 "Home List"\ 
2 "FSTAB Inhalt" 
3 "Verbindungen") 


case Santwort in 
1) 
ls -la /home 


v7 


2) 
cat /etc/fstab 


vv 


3) 
netstat -tu 
ii 

esac 
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Exercise2: Delete an FTP user using kdialog 
#!/bin/bash 


# Name: del_user 

# Purpose: Demonstrate some Functions of kdialog 

# - It makes a list of users of the ftp group in a menu 
# - It shows the content of the user's home directory 
# and asks if it should be deleted as well 

# - It asks for confirmation of the delete operation 
# - If confirmed then it asks for the root password 

# - if password ok then it executes the operation 

# - It then confirms the operation 

# Syntax: del_ftp_user 

# os 

# Preparation: 

# users to delete must be from the group 'ftp' as primary group 
# create users with the command: useradd -m -q ftp username 

#-— aoe 


# Get all the ftp users into a menu 
ftpgid=$ (grep "*ftp:" /etc/group | cut -d: -£3) 
ftpusers=$ (grep ":Sftpgid:" /etc/passwd | grep -v "*ftp:"\ 
| cut -d: -f1) 
# Put the users in a kdialog menu 
index=1 
for user in $ftpusers ; do 
menu="$menu $index $user" 
let index++ 
done 
#echo Smenu 


#--------------- call the kdialog menu 

answer=S (/opt/kde3/bin/kdialog --menu "Select user to delete" Smenu) 
#----------- exit if 'cancel' button is clicked 

[ Sanswer ] || exit 1 


#echo Sanswer 


#----- Retrieve the user from the menu list. Learning && and break 
index=1 
for user in $ftpusers ; do 

[ Sanswer -eq Sindex ] && break 


let index++ 
done 
#echo $user 


#------------ show the content of the home dir of the user 
# get the home dir of the user 
homedir=$(grep "*Suser:" /etc/passwd | cut -d: -£6) 


xterm -e sh -c "ls -la $homedir | less" & 

#------------ get the PID of the xterm 

pid=$! 

#------------ ask if home directory should also be deleted 


/opt/kde3/bin/kdialog --yesno "The content of the home directory 
'Shomedir' of user 'Suser' is \ 

shown in a terminal.\nShould it also be deleted?" 

#echo $? 
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#----------- ask for confirmation of the delete action 

if [ $? -eq 0 ]; then 
# Sure to delete the user AND directory? 
/opt/kde3/bin/kdialog --yesno "Are you sure that you want to\ 
delete the user 'Suser'\nAND his home directory :Shomedir: ?" 


[ $? -eq 0 ] && erase=dir 

else 
# Sure to delete only the user but NOT directory? 
/opt/kde3/bin/kdialog --yesno "Are you sure that you want to\ 
delete the user 'Suser'\nbut NOT his home directory 'Shomedir'?" 
[ $? -eq 0 ] && erase=user 

fi 

#echo Serase 

#exit 

#------------ kill the xterm 

kill $pid 


case Serase in 
dir) 
#------------ get the root password 
passwd=S (/opt/kde3/bin/kdialog --password "Please enter 
root password") 
#------------- Erase the user AND his directory 
if ! (echo $passwd | su - -c "userdel -r $user") ; then 
/opt/kde3/bin/kdialog --error "ERROR: root password is\ 
incorrect.\nUser 'Suser' and his directory 'Shomedir'\ 
will NOT be erased!" 
else 
#------------- Annonce that it is done 
/opt/kde3/bin/kdialog --msgbox "User 'Suser' and his \ 
home directory 'Shomedir' has been erased." 


fi 
user) 
#------------ get the root password 
passwd=S (/opt/kde3/bin/kdialog --password "Please enter\ 
root password") 
#------------- Erase the user but NOT his directory 
if ! (echo Spasswd | su - -c "userdel $user") ; then 
/opt/kde3/bin/kdialog --error "ERROR: root password is\ 
incorrect.\nUser $user will NOT be erased!" 
else 
#------------- Annonce that it is done 
/opt/kde3/bin/kdialog --msgbox "User 'Suser' has been\ 
erased." 
fi 
*) 
#------------- Annonce that delete has NOT been done 


/opt/kde3/bin/kdialog --msgbox "User '$user' and his home\ 
directory 'Shomedir'\nwill NOT be deleted" 


vv 


esac 
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- Trapping kill events 
(Learning: trap, while true, while : ) 
Kill events (messages sent to application via the kill program) can be trapped and a 
program can be called each time the kill event is received. The most common events 
to trap are: 

-kill 15 PID or kill PID 

-kill 2 PID (or CTRL-C sent from the terminal where the script runs) 


See demo script(killtrap) below. 


#! /bin/bash 


# Name: killtrap 

# Purpose: trap a kill(15) command and 

# display an xmessage to tell to 'fuck-off' 
# Syntax: killtrap 

trap "xmessage -center process $$ say fuck off. & " 15 


trap "xmessage -center CTRL-C has been pressed...Humm?" 2 


#Look infinitely while showing the PID of the script process 
# Only a kill -9 will kill him 


while true 


#while 
do 

sleep 5 

echo "Scrip with PID $$ still runs" 
done 


Extra scripts as examples: 


dirmod 
filemod 
translate 
uppercase 
lowercase 
urcp 
colfmt 
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